Reports whether a given handle is a control handle.

Boolean IsValidControlHandle (
    ControlRef theControl
);

Parameter descriptions

theControl

A value of type ControlHandle. Pass the handle to be examined.

function result

true if the specified handle is a valid control handle; otherwise, false.

DISCUSSION

The IsValidControlHandle function confirms whether a given handle is a valid control handle, but it does not check the validity of the data contained in the control itself.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.5 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)